home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / inet_tcp / emcee10 / emcee.doc < prev    next >
Text File  |  1994-11-04  |  40KB  |  1,153 lines
  1.      
  2.  
  3.                                                 █▀▀▀▀▀▀▀ █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  4.                                                 █ ▀█▀▀▀█ █ ▀█▀▄▀█ █▀█ █▀ █▀
  5.                                                 █▀ █ █ █ █▀ █ █ █ █   █  █
  6.                                                 █  █ █▄█ █  █ █ █ █   █▀ █▀
  7.                                                 █  █ █   █  █ █ █ █   █  █
  8.                                                 █  █ █   █▄ █   █ █▄█ █▄ █▄
  9.  
  10.                                                               DOCUMENTATION
  11.  
  12.                                                         Anonymous FTP Emcee
  13.                                                                 Version 1.0
  14.                                                  Vault Information Services
  15.  
  16.                                                          Written by JJ Heim
  17.                                                      jj.heim@boardwatch.com
  18.                                                               November 1994
  19.  
  20.                                                           Copyright (c)1994
  21.                                                         All Rights Reserved
  22.  
  23.  
  24.      1  INTRODUCTION
  25.  
  26.         1.1  Features
  27.  
  28.         1.2  Internet Access
  29.  
  30.         1.3  Requirements
  31.  
  32.         1.4  Unlocking Emcee: REGISTRATION°
  33.  
  34.  
  35.      2  SETUP
  36.  
  37.  
  38.      3  NORMAL FTP ACTIVITIES: Getting Emcee Online
  39.  
  40.         3.1  Connecting to an Anonymous FTP Site
  41.  
  42.         3.2  Listing Directories
  43.  
  44.         3.3  Viewing Files
  45.  
  46.           3.3.1  Viewing HTML Files
  47.  
  48.         3.4  Logging Off
  49.  
  50.         3.5  Direct Communication Link
  51.  
  52.  
  53.      4  FILE TRANSFERS
  54.  
  55.         4.1  Retrieving Documents
  56.  
  57.           4.1.1  Viewing the Last Document
  58.  
  59.         4.2  Downloading
  60.  
  61.         4.3  Uploading
  62.  
  63.         4.4  Transfer Log
  64.  
  65.           4.4.1  Resetting the Transfer Log
  66.  
  67.  
  68.      5  ARCHIE AND WHATIS SEARCHES°
  69.  
  70.         5.1  Viewing the Last Archie Search
  71.  
  72.         5.2  Viewing the Last WhatIs Search
  73.  
  74.         5.3  Specifying Archie Servers
  75.  
  76.  
  77.      6  PERSONAL FTP DIRECTORY
  78.  
  79.         6.1  Adding New Sites
  80.  
  81.  
  82.      7  INSIDE EMCEE
  83.  
  84.         7.1.  CHaiN: Cursor-Happy Navigation
  85.  
  86.         7.2.  Specifying a Home Page
  87.  
  88.         7.3.  Searching the Window
  89.  
  90.         7.4.  Saving the Window to Disk
  91.  
  92.         7.5.  Printing the Window
  93.  
  94.  
  95.      8  TECHNICAL SUPPORT
  96.  
  97.         8.1  Further Information
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.      1. INTRODUCTION
  107.      ______________________________________
  108.      
  109.           Anonymous FTP (File Transfer Protocol) is one of the
  110.      numerous methods of retrieving information the Internet has to
  111.      offer.  This protocol is a direct link to several thousand
  112.      servers offering free anonymous access to a medley of files. 
  113.      More than technical information, and much more that just
  114.      executable programs, the content of an FTP site varies heavily,
  115.      each offering a share to the world's biggest hard drive.
  116.      
  117.           Navigating through anonymous sites, browsing among the
  118.      directories or just downloading files from the flat Unix command
  119.      line can be burdensome.  Emcee is a shell to interact with the
  120.      FTP command line and make your visit easier to use and faster to
  121.      move through.
  122.      
  123.           Emcee also allows integrated access to Archie and Whatis
  124.      databases, to aid in locating and describing files of interest. 
  125.      All aspects of finding, viewing and getting files from FTP are
  126.      featured, from one very "surfable" interface.
  127.      
  128.           Please note: Some anonymous FTP sites request that you
  129.      utilize them during off-peak hours (6am-6pm), while others are
  130.      available 24 hours.  Please respect their wishes as to how you
  131.      use their system, for they're providing a considerable amount of
  132.      virtual happiness to millions.
  133.      
  134.      
  135.      
  136.      
  137.      1.1  Features
  138.      ______________________________________
  139.      
  140.           FTP by itself allows you to browse directories, download,
  141.      upload and view files on FTP sites.  The Archie resource searches
  142.      several thousand anonymous FTP sites for files.  WhatIs searches
  143.      file descriptions.  Both Archie and WhatIs require Telnet access
  144.      and a registered version of Emcee.
  145.      
  146.           Every aspect of interactive Anonymous FTP is integrated into
  147.      Emcee, providing you the most convenient way to fully utilize
  148.      information that's so readily available.
  149.      
  150.      * CHaiN
  151.        Emcee automates the FTP experience through CHaiN, "Cursor-Happy
  152.        Navigation."  By moving the cursor to the desired filename, you 
  153.        can execute a variety of commands just by pressing (enter).  
  154.      
  155.      * Personal Directory
  156.        A Personal Directory also lets you reference favorite sites,    
  157.        files and directories for immediate non-stop access to desired  
  158.        information.  
  159.      
  160.      * Archie/Whatis Searches
  161.        Locate files and file descriptions available from Anonymous FTP 
  162.        sites everywhere.  The outcome of ARCHIE/WhatIs searches bring
  163.        back a formatted listing, fully CHaiNable and ready to escort
  164.        you to interesting resources.
  165.      
  166.      * HTML Support
  167.        Files formatted under the Hypertext Markup Language are         
  168.        automatically translated to their intended nature,
  169.        highlighting FTP site and file references.
  170.      
  171.      * Fully Automated FTP Sessions
  172.        Emcee automatically logs in anonymously, using your email       
  173.        address as the password.
  174.      
  175.      * NSCT Technology  (Windows(tm) Spoof)
  176.        "Never the Same Command Twice"  All directories are remembered  
  177.        from login to logout of each site.  Allows for quick back-      
  178.        stepping.
  179.         
  180.      * On-the-Fly Performance
  181.        Shift through directories/files in memory while receiving       
  182.        more.
  183.      
  184.      * Direct-Link "Raw" Communication Mode
  185.        For troubleshooting or timeout problems: freedom to manually    
  186.        control the connection from the original command line.
  187.      
  188.      
  189.      
  190.      
  191.      1.2  Internet Access
  192.      ______________________________________
  193.      
  194.           Emcee requires that you access the Internet through a
  195.      terminal connection provided by a BBS, online service or dial-up
  196.      server.  Emcee is not a TCP/IP stack of any sort, but rather a
  197.      smart interface used directly over a Unix, Linux or similar dial-
  198.      up "shell account."
  199.      
  200.           The TYPE of terminal interface you use is important.  A good
  201.      dial-up Internet provider should offer one prompt where ALL
  202.      available internet protocols (such as telnet, FTP, finger,
  203.      etc...) can be performed (hereon considered the Host Prompt). 
  204.      This prompt is essential for Emcee to function properly, as it
  205.      offers the preferred "raw" shell.
  206.      
  207.           Equally important is whether your provider uses an FTP
  208.      client that produces VT100 codes (or colors) anywhere WITHIN an
  209.      FTP session (besides the Host Prompt).  These codes generally
  210.      make it easier for the user to navigate, but causes problems due
  211.      to unforseen prompts in the Emcee environment.  Therefore, the
  212.      best solution is a "dumb" terminal connection.  Ask your provider
  213.      just how unfriendly their terminal access can be.
  214.      
  215.      
  216.      
  217.      
  218.      1.3  Requirements
  219.      ______________________________________
  220.      
  221.      * FTP/Telnet access through a terminal-based, or "shell account"  
  222.        Internet connection (see above).  Telnet access optional.
  223.      
  224.      * MS-DOS v3.0+
  225.      
  226.      * Hard drive and a couple free Megs
  227.      
  228.      * 300K available RAM
  229.      
  230.      * VGA/compatible monitor
  231.      
  232.      
  233.      
  234.      
  235.      1.4  REGISTRATION: More Features
  236.      ______________________________________   
  237.      
  238.           Emcee is a fully user-supported application.  If you use
  239.      Emcee for private or commercial purposes, you're asked to pay for
  240.      it.  While not completely enforceable, registering is highly
  241.      respectable and appreciated.
  242.      
  243.           $12 will get you a registered version of Emcee, which
  244.      includes the FULL Archie/Whatis option.  As mentioned above,
  245.      Archie and Whatis searches allow extensive listings of available
  246.      files from hundreds of sites, completely incorporated into an
  247.      Emcee format.  (ARCHIE is based on an interactive Telnet
  248.      connection.)
  249.      
  250.           You can choose to register Emcee by credit card or
  251.      check/money order.  Upon receiving payment, we'll immediately
  252.      email back a Registration Patch and instructions to turn Emcee
  253.      into the official registered version.
  254.      
  255.      
  256.      TO REGISTER BY VISA/MASTERCARD (Zero Paperwork)
  257.      
  258.           The fastest way to register is by sending a scrambled
  259.      version of your credit card number to us through Internet e-mail. 
  260.      E-mail provides an efficient, but not necessarily reliable means
  261.      of communication.  We will not be held responsible for misplaced
  262.      or unsuccessful delivery of e-mail messages, but don't hesitate
  263.      to try.
  264.      
  265.           1) Use the REGISTER utility (distributed with Emcee) to      
  266.              scramble your credit card number and expiration date.     
  267.              This will return a 22-digit scrambled version of your     
  268.              credit card.
  269.      
  270.           2) Send e-mail to: vis@vaultbbs.com  
  271.      
  272.              Include the following:
  273.      
  274.                    1) SUBJECT should be "EMCEE"
  275.                    2) The scrambled version of your credit card
  276.                    3) The cardholder's name
  277.                    4) The e-mail address you use in Emcee
  278.                       (IMPORTANT: make sure it's the same one!)
  279.      
  280.      
  281.      TO REGISTER BY CHECK/MONEY ORDER
  282.      
  283.           Follow the instructions from the Registration command from
  284.      the menubar's first box.  This involves printing a registration
  285.      form and sending it with payment via USPS (snail) mail.
  286.      
  287.      
  288.      
  289.      
  290.      
  291.      
  292.      
  293.      
  294.      2. SETUP
  295.      ______________________________________
  296.      
  297.           Before Emcee can run, the SETUP program needs to configure
  298.      Emcee's basic operating defaults.  The modem port, your e-mail
  299.      address and Host Prompt are mandatory options.  Details of each
  300.      option follows.
  301.      
  302.      
  303.      MODEM PORT 
  304.      The port number where the modem is connected.  Valid: ports 1-4. 
  305.      Com1 & Com3 use IRQ4, Com2 & Com4 use IRQ3 (standard).  If there
  306.      is a need for other IRQs or ports, let me know.
  307.      
  308.      
  309.      PRINTER PORT
  310.      The port number of your printer.  Valid: ports 1-3.
  311.      
  312.      
  313.      E-MAIL ADDRESS
  314.      Your Internet e-mail address.  If you enter a non-standard
  315.      address, some FTP sites will decline access.
  316.      
  317.      
  318.      FILE LOCATION
  319.      Where Emcee's data files are kept.  However, it's good practice
  320.      to keep all of Emcee's files under the same directory as the
  321.      Emcee program.
  322.      
  323.      
  324.      HOST PROMPT 
  325.      The prompt your providing system offers that allows you to
  326.      perform both FTP and Telnet commands from.  Access to at least
  327.      FTP from this prompt is necessary for Emcee to function properly. 
  328.      Some examples: TBBS systems normally use "Cmd>" and Linux systems
  329.      use "~:".
  330.      
  331.      
  332.      FTP COMMAND 
  333.      The command you normally issue at the Host Prompt to connect with
  334.      an FTP site.  (Usually, almost always 'ftp').
  335.      
  336.      
  337.      TELNET COMMAND
  338.      Optional.  Like the FTP Command, the command that will connect
  339.      instead with a Telnet site.  (Most likely 'telnet')  Only needed
  340.      for archie/whatis functions.
  341.      
  342.      
  343.      DIRECTORY COMMAND
  344.      The command that performs a directory listing during a session. 
  345.      (Usually 'dir')  Try typing "help" at an ftp> prompt to see what
  346.      commands you have available.
  347.      
  348.      
  349.      VIEW COMMAND
  350.      The command that shows the content of a file.  If you're using a
  351.      unix-based provider such as Linux, leave this option blank and
  352.      Emcee will simulate a viewing by downloading the file and viewing
  353.      it from your local host.  TBBS's command is "read".
  354.      
  355.      
  356.      MAXIMUM ARCHIE FINDS
  357.      The maximum number of "hits" to bring back during an Archie
  358.      search.  Max: 999.
  359.      
  360.      
  361.      ARCHIE SEARCH TYPE
  362.      This defines the type of Archie searches you wish to perform. 
  363.      Options are:
  364.      
  365.        sub   Substring (case insensitive).  A simple, everyday         
  366.              substring search. A match occurs if the file (or          
  367.              directory) name in the database contains the user-given   
  368.              substring.
  369.      
  370.              Example: "is" will match "islington" and "this" and       
  371.                       "poison"
  372.      
  373.        subcase
  374.      
  375.              Substring (case sensitive). As above but the case of the
  376.              strings involved becomes significant.
  377.       
  378.              Example: "TeX" will match "LaTeX" but not "Latex" or      
  379.                       "TExTroff".
  380.       
  381.        exact
  382.      
  383.              Exact match. The fastest search method of all.  The       
  384.              restriction is that the user string has to _exactly_      
  385.              match (including case) the string in the database.  This  
  386.              is provided for those of you who know just what you are   
  387.              looking for.
  388.      
  389.              For example, if you wanted to know where all the          
  390.              "xlock.tar.Z" files were, this is the kind of search to   
  391.              use.
  392.      
  393.        regex 
  394.              
  395.              This is the DEFAULT search method.  Searches the database 
  396.              with the user (search) string which is given in the form  
  397.              of an ed(1) regular expression.
  398.      
  399.              NOTE: Unless specifically anchored to the beginning (with 
  400.              ^) or end (with $) of a line, ed(1) regular expressions   
  401.              have ".*" prepended and appended to them. For example, it 
  402.              is NOT NECESSARY to say
  403.      
  404.                      prog .*xnlock.*
  405.      
  406.              since
  407.                      prog xnlock
  408.      
  409.              will suffice. Thus the regex match becomes a simple       
  410.              substring match.
  411.      
  412.              There are also compound searches made up of combinations
  413.              of the above search methods in sequence:
  414.      
  415.        exact_sub       
  416.              
  417.              Try "exact". If no matches found use "sub".
  418.              
  419.        exact_subcase   
  420.      
  421.              Try "exact". If no matches found use "subcase"
  422.              
  423.        exact_regex     
  424.       
  425.              Try "exact". If no matches found use regex.
  426.              
  427.      
  428.      
  429.      LOGIN DELAY 
  430.      The amount of time to wait for your provider to successfully
  431.      connect with an FTP Site.
  432.      
  433.      
  434.      PROMPT WAITING DELAY
  435.      The amount of time to wait for the "ftp>" prompt after issuing
  436.      the anonymous FTP logon sequence.
  437.      
  438.      
  439.      TIMEOUT DELAY 
  440.      The amount of *idle* time during a directory listing or file
  441.      viewing session before Emcee declares a timeout and ponders for
  442.      attention.
  443.      
  444.      
  445.      MODIFYING COLORS
  446.      You have the option to customize the colors Emcee displays.  Use
  447.      the Up/Down arrow keys to choose what to change and Right/Left
  448.      keys to change colors.
  449.      
  450.      
  451.      SAVE/EXIT
  452.      Saves changes and exits SETUP.
  453.      
  454.      
  455.      EXIT/ABORT
  456.      Doesn't save any changes and exits SETUP.
  457.      
  458.      
  459.      
  460.      
  461.      
  462.      
  463.      
  464.      
  465.      3. NORMAL FTP ACTIVITIES
  466.      ______________________________________
  467.      
  468.           Emcee is full functioning only after you have connected with
  469.      your provider and positioned their system at the HOST PROMPT
  470.      through a terminal connection.  Shell or exit to DOS from your
  471.      terminal program without dropping the connection, go to Emcee's
  472.      directory and type "emcee".
  473.      
  474.           If Emcee cannot find the HOST PROMPT, you'll be asked to
  475.      manually control the connection and steer the provider's system
  476.      back to the HOST PROMPT.  If you start Emcee without a connection
  477.      at all, you can still play around, but all FTP options are of
  478.      course, disabled.
  479.      
  480.           If all works well, your Personal Directory pops up and
  481.      you're ready to go.
  482.      
  483.      
  484.      
  485.      
  486.      3.1.  Dialing an Anonymous FTP Site
  487.      ______________________________________
  488.      
  489.      An FTP site name looks like this: oak.oakland.edu
  490.      
  491.      * Use the "Connect/Relieve" command from the Personal Directory
  492.      <F1> to connect with the highlighted entry, or
  493.      
  494.      * If you notice a site name ANYWHERE in the window, move the
  495.      cursor to it and press (Enter).  Use the "Connect" command to
  496.      visit the site.
  497.      
  498.      NOTE: It's unnecessary to logoff before connecting to another
  499.      site.
  500.      
  501.      If you press (Esc) while waiting to connect, you'll be given the
  502.      option to RETRY, ABORT or perform a DIRECT COMMUNICATION LINK.
  503.      
  504.      
  505.      
  506.      
  507.      3.2.  Listing Directories
  508.      ______________________________________
  509.      
  510.      Upon connecting with an FTP site, Emcee will automatically
  511.      retrieve the first directory.  The listing may look somewhat
  512.      complex, but somewhere in the listing, there will be directory
  513.      names and files.  You might see something like:
  514.      
  515.                                           Size      Filename/Directory
  516.                                       --------              ----------
  517.      -rw-r--r--   1 pvo      staff        6130 Aug  3 10:24 README
  518.      -rw-r--r--   1 pvo      staff         512 Jan  6  1993 Adlib-Gold
  519.      -rw-r--r--   1 pvo      staff         512 Apr 16  1992 Alesis-D4
  520.      -rw-r--r--   1 pvo      staff         512 Dec 11  1992 Analog_FAQ
  521.      -rw-r--r--   1 pvo      staff       90926 May 18  1993 CD-ROM.txt
  522.      -rw-r--r--   1 pvo      staff         512 Apr 19 13:36 CDI-FAQ
  523.      -rw-r--r--   1 pvo      staff         512 Mar  4  1992 Casio-VZ
  524.      -rw-r--r--   1 pvo      staff         512 Apr 15  1992 Chroma
  525.      
  526.      The names and directories appear on the far right-hand of the
  527.      screen.   
  528.      
  529.      Directories are distinguished by having a SIZE of 512 or
  530.      multiple.  
  531.      
  532.      (1) Position the cursor so it's touching the name of the
  533.      directory, and press (Enter).  
  534.      
  535.      (2) Make sure the directory you wish to move to is listed in the
  536.      box and press (Enter) again.
  537.      
  538.      (3) Use the "Directory" command to list it.
  539.      
  540.      
  541.      
  542.      
  543.      3.3.  Viewing Files
  544.      ______________________________________
  545.      
  546.      (1) Move the cursor to the file you wish to view and hit (enter). 
  547.      
  548.      (2) Confirm the name and press (Enter) again.
  549.      
  550.      (3) Use the "View" command to view it.
  551.      
  552.      
  553.      
  554.      
  555.      3.3.1.  Viewing HTML Files
  556.      ______________________________________
  557.      
  558.      Same as above, but when the file is received, it'll be structured
  559.      automatically to a readable format, highlighting all FTP sites
  560.      and file references.
  561.      
  562.      
  563.      
  564.      
  565.      3.4.  Logging Off
  566.      ______________________________________
  567.      
  568.      Press <F8> to immediately log off the FTP site you're connected
  569.      to.  If you perform this while receiving a file, there may be an
  570.      unexpected delay, in which case Emcee will react with an urge to
  571.      perform a Direct Communication Link.
  572.      
  573.      
  574.      
  575.      
  576.      3.5.  Direct Communication Link
  577.      ______________________________________
  578.      
  579.      Press <F9> to get to a command prompt.  This will place you in
  580.      direct contact with your provider's system, where you can
  581.      manually issue commands.
  582.      
  583.      Press <Esc> when you finish.  It's a good idea to return to the
  584.      Host Prompt before going back into Emcee.  If you're in an FTP
  585.      session, Emcee will take you out of the Link and start over.
  586.      
  587.      
  588.      
  589.      
  590.      
  591.      
  592.      
  593.      
  594.      4. FILE TRANSFERS
  595.      ______________________________________
  596.      
  597.      The most important aspect of FTP is, well, it's files.  Downloads
  598.      are sent from the remote FTP site to your provider's system where
  599.      you must manually download them again to YOUR system, later.
  600.      
  601.      
  602.      
  603.      
  604.      4.1.  Retrieving Documents
  605.      ______________________________________
  606.      
  607.      Retrieving a document places a remote file's content in the
  608.      window and makes it the "Last Document".  During an FTP session,
  609.      use the "view" command to get the same results without disturbing
  610.      the actual Last Document.
  611.      
  612.      You'll need the site+filename to successfully retrieve.
  613.      
  614.      (1) Press (Enter) anywhere on the screen. 
  615.      
  616.      (2) Erase whatever CHaiN captured and input the site, followed by
  617.      "/" and then the directory and filename (no spaces).  Press
  618.      (Enter).
  619.      
  620.      (3) Choose "Connect".
  621.      
  622.      (4) Choose "Document (Screen)".
  623.      
  624.      Emcee will call the site, and retrieve the file to your screen,
  625.      then logoff.  This file will remain the Last Document until you
  626.      perform this again.
  627.      
  628.      
  629.      
  630.      
  631.      4.1.1.  Viewing the Last Document
  632.      ______________________________________
  633.      
  634.      Pressing <Alt-D> will display the last document you retrieved.
  635.      
  636.      
  637.      
  638.      
  639.      4.2.  Downloading
  640.      ______________________________________
  641.      
  642.      * If you're in an active FTP session:
  643.      
  644.      (1) Move the cursor to the filename you wish to download, and
  645.      press (Enter).
  646.      
  647.      (2) Confirm by pressing (Enter) again.
  648.      
  649.      (3) Choose "Download".
  650.      
  651.      (4) Then you must choose what type of transfer to perform. 
  652.      Choose BINARY for compressed or executable files.  Use ASCII if
  653.      this is a text file.  DOCUMENT will bring the file directly to
  654.      the screen.
  655.      
  656.      You'll be informed how the transfer succeeded (usually a matter
  657.      of seconds) and the transaction will be recorded in the Transfer
  658.      Log.
  659.      
  660.      
  661.      * If you already know the site and filename and don't want to
  662.      visit the site:
  663.      
  664.      
  665.      (1) Press (Enter) anywhere on the screen. 
  666.      
  667.      (2) Erase whatever CHaiN captured and input the site, followed by
  668.      "/" and then the directory and filename (no spaces).  Press
  669.      (Enter).
  670.      
  671.      (3) Choose "Connect".
  672.      
  673.      (4) Choose the correct transfer method (see above).
  674.      
  675.      Emcee will call the site, download the file, then logoff. 
  676.      Activity is recorded in the Transfer Log.
  677.      
  678.      
  679.      
  680.      
  681.      4.3.  Uploading
  682.      ______________________________________
  683.      
  684.      Make sure you have previously uploaded the file to you provider's
  685.      system before uploading the file to the remote FTP site.
  686.      
  687.      
  688.      (1) Connect to the site where you wish to upload the file.
  689.      
  690.      (2) Position Emcee in the remote FTP site's directory where you
  691.      wish to leave the file.
  692.      
  693.      (3) Press <F2>.
  694.      
  695.      (4) Input the name of the file that you wish to upload.  This
  696.      file MUST be already present on your provider's system.
  697.      
  698.      (5) Choose the appropriate transfer method (same idea as
  699.      downloads, see above).
  700.      
  701.      Emcee will send the file to the remote FTP site and tell you how
  702.      it went, as well as record the transaction in the Transfer Log.
  703.      
  704.      
  705.      
  706.      
  707.      4.4.  Transfer Log
  708.      ______________________________________
  709.      
  710.      All uploading and downloading attempts are recorded in the
  711.      Transfer Log.  Press <Alt> to invoke the menubar.  You'll find
  712.      the Transfer Log under "Transfer".
  713.      
  714.      
  715.      
  716.      
  717.      4.4.1.  Resetting the Transfer Log
  718.      ______________________________________
  719.      
  720.      It may become necessary to reset or clear the transfer log of
  721.      it's content.  Press <Alt> to invoke the menubar.  You'll find
  722.      the command to Reset Transfer Log under "Transfer".
  723.      
  724.      
  725.      
  726.      
  727.      
  728.      
  729.      
  730.      
  731.      5. ARCHIE AND WHATIS SEARCHES°
  732.      ______________________________________
  733.      
  734.           Finding available files or descriptions of files is just a
  735.      quick Telnet trip to an anonymous Archie server.  Completely
  736.      automated file searching is one of Emcee's strong points.  Emcee
  737.      returns an easy-to-use list of sites and filenames that you can
  738.      point-and-click on for direct access to what you want.
  739.      
  740.      
  741.      * To look for filenames via Archie:
  742.      
  743.      (1) Press <Alt-A>.  Doesn't matter if you're in an FTP session.
  744.      
  745.      (2) Input your requests (5 max) and press (Enter) on a blank line
  746.      when finished.
  747.      
  748.      (3) Choose "Connect/Search".
  749.      
  750.      Emcee randomly chooses an Archie server and attempts a connection
  751.      with it.  If it fails to connect, Emcee moves to the next server,
  752.      until a reliable server is connected with.  If you know a server
  753.      is dysfunctional, slow, or simply don't want to use the server
  754.      Emcee is attempting to connect with, press <Esc> to move down the
  755.      list.
  756.      
  757.      Emcee then requests a search and the output of this search is
  758.      immediately placed on the screen.  BEAR IN MIND, this is not the
  759.      same structure you'll finally be presented with.  
  760.      
  761.      Press <Esc> to abort and structure what's been found.
  762.      
  763.      
  764.      * To look for file descriptions via WHATIS:
  765.      
  766.      (1) Press <Alt-W>.
  767.      
  768.      (2) Input your requests.
  769.      
  770.      (3) Choose "Connect/Search".
  771.      
  772.      Same results as an Archie search (above). 
  773.      
  774.      
  775.      
  776.      
  777.      5.1.  Viewing the Last Archie Search
  778.      ______________________________________
  779.      
  780.      To display the results of the last Archie search, press <Alt> to
  781.      get to the menubar.  You can View Last Archie under "Connection".
  782.      
  783.      
  784.      
  785.      
  786.      5.2.  Viewing the Last Whatis Search
  787.      ______________________________________
  788.      
  789.      To display the results of the last WhatIs Search, press <Alt> to
  790.      get to the menubar.  You can View Last Whatis under "Connection".
  791.      
  792.      
  793.      
  794.      
  795.      5.3.  Specifying Archie Servers
  796.      ______________________________________
  797.      
  798.           There are numerous Archie servers located all over the world
  799.      that allow anonymous access to their databases.  Some work better
  800.      than others, but all offer a wide search, sometimes over
  801.      different FTP sites, which may lead to different listings from
  802.      each Archie server.
  803.      
  804.           Emcee is compatible with most anonymous archie servers. 
  805.      Experiment; if a timeout or heavy delay occurs, keep the site
  806.      away from your list.  Emcee shuffles through a list of servers
  807.      until connected successfully.
  808.      
  809.           Each server asks for at least a login name and sometimes a
  810.      password.  Most anonymous archie servers will let you in with a
  811.      login of "archie".  The ARCHIE.LST configuration file contains
  812.      the archie.site.name, login and password of each site.  Emcee
  813.      comes PRECONFIGURED with several archie servers (many are out of
  814.      the US and barely used at time of this writing= FAST RESPONSE!)
  815.      Follow the format that appears in ARCHIE.LST to add more or
  816.      rearrange the server order. (9 maximum)
  817.      
  818.      
  819.      
  820.      
  821.      
  822.      
  823.      
  824.      
  825.      6.  PERSONAL FTP DIRECTORY
  826.      ______________________________________
  827.      
  828.           This directory is your customized guide to the world of FTP. 
  829.      The sites you want to visit again, the directories you want to
  830.      frequent, and the files you'd like to receive can be placed here. 
  831.      Each entry has a corresponding character to identify its function
  832.      when called upon:
  833.      
  834.                 :Visit FTP site
  835.                  
  836.                    Format: ftp.site.name
  837.                   Example: oak.oakland.edu
  838.      
  839.      
  840.                ≡ :Visit FTP site, begin session in specified directory
  841.      
  842.                    Format: ftp.site.name/directory/
  843.                   Example: oak.oakland.edu/pub/               
  844.                            (!! Note the trailing slash !!)
  845.      
  846.        
  847.                ¥ :Wishlist- Visit FTP site, download specified         
  848.                   filename, and logoff
  849.      
  850.                    Format: ftp.site.name/directory/filename       
  851.                   Example: oak.oakland.edu/pub/README
  852.      
  853.      
  854.      
  855.           Use the Left/Right arrow keys to preset your command and
  856.      then Up/Down keys to change entries.  Hit (enter) to invoke. 
  857.      
  858.      
  859.      Some of the examples above use the Personal Directory to
  860.      demonstrate how to connect to sites (Connect/Relieve).  Please
  861.      see these references for correct use.
  862.      
  863.      For the most part, the options available from within the Personal
  864.      Directory should be self-explanatory.
  865.      
  866.      CONNECT/RELIEVE: Connects to the site listed in the entry and
  867.      performs tasks, depending on its corresponding character (see
  868.      above.)
  869.      
  870.      SEARCH: Searches the Directory for a keyword.  Press <SPACE> to
  871.      bring up the next find.
  872.      
  873.      ADD: Allows you to add another site to visit, directory to FTP
  874.      to, or filename to download (see below.)
  875.      
  876.      REVISE: Allows you to edit the entry.
  877.      
  878.      ERASE: Erases the entry.
  879.      
  880.      
  881.      
  882.      
  883.      6.1.  Adding New Sites
  884.      ______________________________________
  885.      
  886.      Not only can you add new sites, but also directories and
  887.      filenames to frequent.  You may specify a site, site+directory or
  888.      site+directory+filename (see above for example formats.)
  889.      
  890.         SITE: Just enter the ftp.site.name or its corresponding IP    
  891.          number.
  892.        
  893.        ≡ SITE/DIRECTORY: Enter the ftp.site.name, a "/" and directory  
  894.          name to start from, FOLLOWED BY TRAILING "/".
  895.        
  896.        ¥ SITE/FILENAME: Enter the ftp.site.name, a "/" and filename to 
  897.          retrieve.
  898.      
  899.      When you "Connect/Relieve" on an entry, Emcee will automatically
  900.      perform the task according to the little graphics character
  901.      beside each entry.
  902.      
  903.      
  904.      
  905.      
  906.      
  907.      
  908.      
  909.      
  910.      7.  INSIDE EMCEE
  911.      ______________________________________
  912.      
  913.      The following are miscellaneous commands and options to better
  914.      understand and use Emcee.
  915.      
  916.      
  917.      
  918.      
  919.      7.1.  CHaiN: Cursor-Happy Navigation
  920.      ______________________________________
  921.      
  922.           Like the popular hypertext interface that allows you to
  923.      follow specific information by highlighting a word or phrase,
  924.      Emcee's CHaiN lets you point at a word (in this case a directory
  925.      or filename) and press <Enter> to use the word as the argument
  926.      for viewing a file, listing a directory, downloading a file and
  927.      even connecting to another site.  CHaiNing can be done from any
  928.      document that appears in the window.
  929.      
  930.           In order for this function to work, however, you'll need to
  931.      know what text of an FTP session can be used as an argument.  For
  932.      instance, while viewing a directory, you may see something like:
  933.      
  934.                                           Size      Filename/Directory
  935.                                       --------              ----------
  936.      -rw-r--r--   1 pvo      staff        6130 Aug  3 10:24 README
  937.      -rw-r--r--   1 pvo      staff         512 Jan  6  1993 Adlib-Gold
  938.      -rw-r--r--   1 pvo      staff         512 Apr 16  1992 Alesis-D4
  939.      -rw-r--r--   1 pvo      staff         512 Dec 11  1992 Analog_FAQ
  940.      -rw-r--r--   1 pvo      staff       90926 May 18  1993 CD-ROM.txt
  941.      -rw-r--r--   1 pvo      staff         512 Apr 19 13:36 CDI-FAQ
  942.      -rw-r--r--   1 pvo      staff         512 Mar  4  1992 Casio-VZ
  943.      -rw-r--r--   1 pvo      staff         512 Apr 15  1992 Chroma
  944.      
  945.                                                             ^^^^^^^^^
  946.                                                             |||||||||
  947.      
  948.           The "stuff" in the far right-hand of the screen is what you
  949.      want to move the cursor to.  It contains both directory and file
  950.      names.  Press (Enter) to record the word the cursor is
  951.      immediately touching.  You'll have the chance to edit the word if
  952.      necessary, and press (Enter) again to confirm the argument.
  953.      
  954.           You can now use this word to perform the following commands:
  955.      
  956.      
  957.      DIRECTORY
  958.        Sends a directory command to the remote FTP system, using the   
  959.        CHaiNed argument as the directory to list.
  960.      
  961.        A directory usually has an exact file size that's a multiple    
  962.        of 512.  If you accidentally perform a directory listing on a   
  963.        file, you can <Esc> and try again.
  964.      
  965.        Each directory listed REMAINS IN MEMORY for later access, and   
  966.        the entire line where you CHaiNed from becomes highlighted.  To 
  967.        access this directory again, you must return the cursor to the  
  968.        original word and hit <Enter>, this time only once.
  969.      
  970.      
  971.      VIEW
  972.        Sends a view command to the FTP site, using the CHaiNed         
  973.        argument as the file to view.  Each file viewed REMAINS IN      
  974.        MEMORY for later access, and the entire line where you CHaiNed  
  975.        from becomes highlighted.  To access this file again, you must  
  976.        return the cursor to the original word and hit (enter) only     
  977.        once.
  978.      
  979.        Emcee supports HTML (Hypertext Markup Language).  These files   
  980.        normally have "html" somewhere in the name.  When the file has  
  981.        been completely received, Emcee attempts to translate it.  All  
  982.        FTP sites or filenames listed are highlighted and can be        
  983.        CHaiNed to immediately.
  984.      
  985.      
  986.      DOWNLOAD
  987.        Sends a download command (get) to the FTP site, this time using 
  988.        the CHaiNed argument as the filename to download.
  989.      
  990.        You'll be asked the type of method that should be used to       
  991.        transfer the file from the site to your provider's computer.    
  992.        Use BINARY for executable or compressed files, and ASCII for    
  993.        general text files.  Choose DOCUMENT if you'd like the file's   
  994.        contents to appear on the screen.  NOTE: Document transfers are 
  995.        kept in Emcee and available from the LAST DOCUMENT command from 
  996.         the menubar for later access.
  997.      
  998.        You'll then be asked to enter a destination for this file.      
  999.        Type in the name it should be saved to your provider's system   
  1000.        under.
  1001.      
  1002.      
  1003.      CONNECT
  1004.        Much like the "Connect/Relieve" command from your Personal FTP  
  1005.        Directory.  Using the CHaiNed argument, Emcee automatically     
  1006.        connects with a site and lists a home directory or downloads a  
  1007.        file, according to the entry's format.
  1008.      
  1009.        Archie searches are automatically formatted to work with this   
  1010.        command.
  1011.      
  1012.      
  1013.      PERSONAL
  1014.        If you're attempting to save the CHaiNed argument to you        
  1015.        Personal Directory as a SITE, SITE/DIR or FILE entry, use the   
  1016.        Up/Down cursor keys to specify it and press (enter).  Emcee     
  1017.        alters the argument accordingly.
  1018.      
  1019.      
  1020.      
  1021.      
  1022.      7.2.  Specifying a Home Page
  1023.      ______________________________________
  1024.      
  1025.      Popular these days is the ability to move from one network to
  1026.      another using as few keystrokes as possible.  "Home Pages" are
  1027.      used to direct people and computers to different places, and with
  1028.      Emcee's CHaiN feature, this type of traveling can be achieved
  1029.      here too, using FTP.
  1030.      
  1031.      With Emcee, a Home Page is actually a text file that gets
  1032.      displayed under the "FTP Home Page" command from the menubar. 
  1033.      This text file can hold any type of content, including links to
  1034.      FTP sites.
  1035.      
  1036.      * To import a text file to be used as a Home Page...
  1037.      
  1038.      (1) Rename the file to "HOMEPAGE", and
  1039.      (2) place the file in the directory where Emcee resides.
  1040.      
  1041.      Emcee will recognize this file when started and translate it for
  1042.      use within Emcee.  Whenever you wish to view it, use the "FTP
  1043.      Home Page" command under Connections from the menubar.
  1044.      
  1045.      
  1046.      * This can also be achieved WHILE using Emcee.
  1047.      
  1048.      If you've just retrieved a document to screen that you want to
  1049.      use as your Home Page...
  1050.      
  1051.      (1) Perform a "WINDOW->DISK" command under Window from the
  1052.      menubar <Alt>.
  1053.      
  1054.      (2) Save the document as "HOMEPAGE", making sure it get's placed
  1055.      in Emcee's directory.  The actual Home Page will change when you
  1056.      start Emcee again.
  1057.      
  1058.      
  1059.      
  1060.      
  1061.      7.3.  Searching the Window
  1062.      ______________________________________
  1063.      
  1064.      To look for a keyword in the window that's currently being
  1065.      displayed...
  1066.      
  1067.      (1) Press <F5> and enter a keyword.
  1068.      
  1069.      Emcee will look through the entire document and move the cursor
  1070.      to the keyword, if found.  Use <SPACE> to bring up the next find.
  1071.      
  1072.      
  1073.      
  1074.      
  1075.      7.4.  Saving the Window to Disk
  1076.      ______________________________________
  1077.      
  1078.      * To save only what's being displayed in the window...
  1079.      
  1080.      (1) Use the "In View->DISK" command under Window from the menubar
  1081.      <Alt>.
  1082.      
  1083.      (2) Input a valid filename to save the filename as.
  1084.      
  1085.      
  1086.      * To save the entire document that's in the window...
  1087.      
  1088.      (1) Use the "Window->DISK" command under Window from the menubar
  1089.      <Alt>.
  1090.      
  1091.      (2) Input a valid filename to save the filename as.
  1092.      
  1093.      
  1094.      
  1095.      
  1096.      7.5.  Printing the Window
  1097.      ______________________________________
  1098.      
  1099.      * To print only what's being displayed in the window...
  1100.      
  1101.      (1) Use the "In View->PRINTER" command under Window from the
  1102.      menubar <Alt>.
  1103.      
  1104.      
  1105.      * To print the entire document that's in the window...
  1106.      
  1107.      (1) Use the "Window->PRINTER" command under Window from the
  1108.      menubar <Alt>.
  1109.      
  1110.      
  1111.      If your printer port is defined correctly in SETUP, Emcee will
  1112.      print your selection.
  1113.      
  1114.      
  1115.      
  1116.      
  1117.      
  1118.      
  1119.      
  1120.      
  1121.      8.  TECHNICAL SUPPORT
  1122.      ______________________________________
  1123.      
  1124.           Should something not work properly or an error occurs, feel
  1125.      free to contact me.  Emcee has been tested and successfully run
  1126.      from remote, dial-up TBBS and Linux systems. 
  1127.      
  1128.      
  1129.           Internet email: jj.heim@boardwatch.com
  1130.              Voice Phone: 303-696-8983
  1131.      
  1132.      
  1133.      
  1134.      
  1135.      8.1  Further Information
  1136.      ______________________________________
  1137.      
  1138.           If you're new to the whole Internet thing, check out Brendan
  1139.      P. Kehoe's "Zen and the Art of the Internet: A Beginner's Guide,"
  1140.      available in electronic text at several FTP sites and online
  1141.      services everywhere.
  1142.      
  1143.           If you're just looking for further information on FTP, the
  1144.      Internet or anything in general, look for FAQ files (frequently-
  1145.      asked questions) available on an enormous amount of information,
  1146.      via FTP sites everywhere.
  1147.      
  1148.      
  1149.      
  1150.      Good luck and happy FTPing!
  1151.      JJ Heim, Emcee author
  1152.      
  1153.